Recommend secure-hash in md5 docstring
authorStefan Kangas <stefankangas@gmail.com>
Fri, 28 Feb 2025 04:21:48 +0000 (05:21 +0100)
committerStefan Kangas <stefankangas@gmail.com>
Fri, 28 Feb 2025 04:22:53 +0000 (05:22 +0100)
* src/fns.c (Fmd5): Repeat explanation from manual about md5 being
"semi-obsolete", and recommend using secure-hash instead.

src/fns.c

index a37c651c793c1836212e02f0d247b788406de884..8444a9edb0058221ccb0dab9abd426629c5fc076 100644 (file)
--- a/src/fns.c
+++ b/src/fns.c
@@ -6385,6 +6385,11 @@ command `prefer-coding-system') is used.
 If NOERROR is non-nil, silently assume the `raw-text' coding if the
 guesswork fails.  Normally, an error is signaled in such case.
 
+This function is semi-obsolete, since for most purposes it is equivalent
+to calling `secure-hash` with the symbol `md5' as the ALGORITHM
+argument.  The OBJECT, START and END arguments have the same meanings as
+in `secure-hash'.
+
 Note that MD5 is not collision resistant and should not be used for
 anything security-related.  See `secure-hash' for alternatives.  */)
   (Lisp_Object object, Lisp_Object start, Lisp_Object end, Lisp_Object coding_system, Lisp_Object noerror)